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The Futuredata RDOS consists of three new programs* AS'MR* a 
relocating macro assembler* LINK, a linkage editor* and DEBUGR* a 
debugger which supports In Circuit Emulation and Symbolic 
Debugging. 

i. RDOS MACRO ASSEMBLER 

Run the Assembler by typing JA. The available options will be 
displayed on the screen. 

i. 0 ASSEMBLER OPTIONS 



L ~ , List the Assembler output on the CRT. 



M - Use a macro library file. 



0 - Write a relocatable file on disk. 



T - Produce a truncated listing on the CRT. Lines will be 

limited to 40 characters and DC statements will print only 



Include the symbol table at the end of the relocatable object- 



one line. 



E 



List and/or print only the lines which have an error flag. 



file. 



1 - 



This option will flag all lines with non-8080 or 8085 
opcodes. 



P - 



Print the listing on the Microprinter. 



B - 



Send the listing to the Serial Port. 
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1. 1 MACROS 

The macro facility all ows a use r to define a n o p c o d e w h i c h 
actually causes a series of instructions to be assembled. For 
example* using the 8080, the following series of instructions will 
add 10 to the H and L registers* using only the A register. 

MOV A,L 
AD I 10 
MOV L» A 

MOV A, H 

ACI 0 
MOV H» A 

If the user finds many such sequences in his programs, he will 
find it more efficient (of his time and disk space) and less error 
prone to define a macro that ujill cause the sequence of 
instructions to be assembled whenever its name appears in the 
o p c o d e f i e 1 d : 



ADD 10 



MACRO 




MOV 


A/ L 


AD I 


10 


MOV 


L, A 


MOV 


A, H 


ACI 


0 


MOV 


H, A 


ENDM 





The macro definition is begun by the MACRO pseudo-op. The label 
field of the MACRO pseudo-op defines the name of the macro, in 
e x am pie i. * ADD i. 0. S t a t em e n t s f o 1 1 ow i ng t h e MACRO p s e u d o- o p 
represent the body of the macro definition. These statements will 
be processed by the assembler when the macro name occurs in the 
op c o d e field < w h e n t h e m a c r o is -' c a 1 1 e d •' ) . The ENDM p s e u d o- op 
e n d s t h e m a c r o d e f i. n i 1 1 o n. T he ma c r o d e f i n i t i o n m us t b e p 1 a c e d a t 
t h e beg i n n i n g o f the ass em bier s o u r c e file, only t h e E JE , SF'C , a i « •:! 
PRNT pseudo-ops may occur before the macro definitions. 

1. 1.1 MACRO PARAMETERS 

i ■. ■ 
Obviously, a macro definition like ADD10 is of limited use. How 
many times would you add the number 10 to the H and L registers? 
It is m u c h m o re likely that similar rat h e r t nan identical 
s e q u fences o f ins t r u c t i o n s o c cur in a p r o gram. All ow i n g a ma C r o 
definition to have variables that may have various values when the 
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mao.ro is called is one way of doing this. For example* if we make 
the actual value added to the H and L registers a macro parameter* 
the user can define a macro that, when called; will generate 
statements that will add any number from 0 to 255 to the H and L 
r eg i s ters: 



ADDX 



MACRO 


NUM 


MOV 


A» L 


AD I 


&NUM 


MOV 


L, A 


MOV 


A, H 


AC1 


0 


MOV 


H* A 


EN DM 





I f t h e m a c r o is called i n t h e f oil ow i n g w a y : 

VALADR 
VALADR 

The -following statements will be generated: 



LHLD 
ADDX 
SHLD 



LHLD 


VALADR 


MOV 


A, L 


AD I 


5 


MOV 


L* A 


AC I 


0 


MOV 


H* A 


SHLD 


VALADR 



W h a t h a p p e n s i s t h a t i n t h e mac r o d e f i n i t i o n * t h e nam e s o f all t h e 
macro parameters are listed (separated by commas) in the operand 
field of the MACRO pseudo-op. When the macro is called* the 
a c t u a 1 values t o b e u s e d a r e lis t e d i n t h e op e r a n d field o f t h e 
o a 1 1 i n g s t a t em e n t ( s e p a r a t e d b y c omm as). T h e ri * w h e r e v e r a m a c r o 
p a r a m e t e i - n a rn e a p p e a r s i n t h e b o d y o f the m a c r o d e f i n i t i o n * 
preceeded by an ampersand* the actual value of the parameter is 
substituted in place of the ampersand and name. Note that this 
s u b s t i t u t i o n i s d o n e c h arac t e r f o r c h a r a c t e r ( u p t o 32 c hara c t e r s 
p e i" p a r am e t e r ) . T h e rn a c r o p a r am e ters n eed n o t b e n urn eric. A 1 s o * 
the substitution may occur in the label* opcode* operand* comment* 
o r any c o rri b i n a t .i o n o f fields. F o r example* f o r t he ma c r o 
def i ni ti on: 



save: a 



MACRO 
&TYPE 
£NDM 



TYPE* LOC 
&LOC * 
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The call: 

SAVEA ST A # VAL 

•oi .1 1 resul t in: 

ST A VAL 

whi I e the cal 1 : 

SAVEA STAX,D 

will result in: 

ST AX D 
1.1. L I MACRO PARAMETER DEL I METERS 

As stated* when a macro is called' the actual values of the 
p a r a m e t e r s a r e lis t e d i n t h e o p erand fie 1 d o f t h e calling 
statement' separated by commas. However* commas and blanks may 
e x \ s I in a p a r a m e t e r i f t hey o <:. c. u r b e t w e e n q u o t e s . Also* t h ere 
must be an even number of quotes in any parameter. The following 
are examples of valid parameters: 

20 

X- 4 *0 - 

• A' B ' + ' B' C " 

A - • • C 
ABC 

1. 1. 2 GENERATING UNIQUE LABELS 

A macro call may generate statements with labels. For example* 
t h e f o i I ow i n g d e f i n i t i o n : ► < t o m a k e D » E= a b s o 1 u t e value o f D * E ) 



A BSD MACRO 



MOV A, D 

OR A A 

JP ENDABSD 

CMA 

MOV D'A 

MOV E* A 

CMA 

MOV E» A 

I NX D 

ENDABSD EQU . * 



EN DM 
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The first time ABSD is called, label EN DA BSD will be defined. 
Unfortunately, the second time ABSD is called, EI ND ABSD will also 
be defined and a duplicate definition error will result. What is 
needed is a way to generate a unique label each time the macro is 
called. The Futuredata Macro Assembler provides this capability 
b y p i" e~ d e f :i n i n g a s p e c i a 1 p a r am e t e r - I ND X - w h i c h w ill a 1 w ays 
have a unique 5 digit numeric value each time a macro is called. 
The macro ABSD may now be defined in the following way: 



ABSD MACRO 



MOV A, D 

OR A A 

UP AB&INDX 
CM A 

MOV D, A 

MOV A, £ 
CM A 

MOV E, A 

INX D 

AB&INDX EQU * 

ENDM 



Assuming that this is the only macro defined and that there are 
exactly two calls made, the first call defines the label ABOOOOl 
and the second call defines' the label AB00002. Note that a label 
on the actual macro call statement takes on the current location 
c o u n t e r value at t h e t:< e g i n n i n g o f t he c a' 1 1 . 

1. 1.3 CONCATENATING PARAMETERS 



In the previous example, the value of parameter INDX was appended 
t o t h e r i g ft t o f t h e c h a r a c t e r s AB simply by w r i. t i n g the p a r am e t e r 
1 1 a m e » p r e c e e d e d by art a m p e r s a n d , t o t h e i m m e d i a t e r i g h t o f t h e 
c h a r a c t e r s A B : A B& I M D X . If, a 1 s o , t h e use r w i s h e d t o a p p e n d a n 
to the right of the value of parameter INDX, a problem would have 



ar "i sen: 



JP AB&INDXA 



T h e m a c r o p r o cess o r w o u 1 d have i n t e r p r e t e d t his t o me a n : S u b s t i t u t 
the value for parameter INDX A. To solve this problem, the macro 
processor recognizes a parameter name delimiter: ! whose only 
f u n c 1 1. * n i s to ind i c a t e t h e e n d o f a parameter name. T h e c or r e c t 
way to append an A to the right of the value of parameter INDX is 



JP AB&INDXIA 



On the first call, this would result, in the statement: 
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JP ABOOOOiA 

N o t e X h a X i f ! a p p e a r s a n y w h e r e o t h e r X h a n a f X e r a rn a c r o para rn e t e r 
(or a set symbol )# it will be treated as a normal character. 

1.1. 4 LITERAL AMPERSAND 

Since the ampersand signals the macro processor to substitute a 
parameter value* a special set of characters is needed to tell the 
ni acr o p r o c e s s o r t h a t r a t h e r t h a n s u b s t i t u ting* a n actual am p e r s a n d 
character is wanted. For example, if the user wants to put an 
ampersand into the A register, he might think to -write: 

mv:i a, 

However, for reasons explained under Advanced Considerations, 
whenever a single ampersand as wanted in the generated statement, 
four ampersands must be written in the actual source: 

Mv t a i 

i. 1. 5 MACRO LIBRARY 

A 1 1 m a c r o d e f i. n i t i o n s m u s t b e placed at the b e g i n n i n g o f t h e 
s o u i • c e i n p u t f i 1 e . H «:• w e v e r , by s p e c i f y i n g t h e M o p 1 1 o n .• a s e c o ri d 
s o o r - c e f i 1 e o f m a c r d e f i n i t i o n s may be i n c 1 u d e d i n t he assembly. 
A s :l n X h e m a in i n p u t f :t 1 e » X h e f irst s t a t e m e n X o t h e r t h a n E ■ JE , 
SPC , a n d PR 1 NT w h i. c h i. s n o t i n a ma c r o d e f i n i t i o n w ill t e rm i na t e 
r e a «:l :i n g o f m a <:. r o d e f :L n :t t i o n s . 

L 1. 6 DUPLICATE MACRO DEFINITIONS 

If two macros with the same name are defined, the last macro 
d e f 1 ri 1 1 i o n r e a d w ill be t h e o n e use d. T h u s m a c r o d e f i n i t ions in 
1 1 1 e rn a :i n s o u r c e file t a k e p r e c e d e n c e o v e r rn a c r o d e f i n i t i o n s l n t h e 
macro 1 i. brary 

1. i. 7 MACRO CALLS WITHIN MACROS 

A in a r o d e f i ri i t i o n m ay i n c 1 u d e a s t a t em e n t w h i c h calls an o t her* ( o r 
the same) macro. These calls may be nested to any level 
(depending on the symbol table space available). A macro 
d «.-.' f :i r i x X i on may n o t have a n o t h e r m a c r o defined in its b o d y . 

i. 1. 3 feXITM STATEMENT 

When processed, the EXJ.TM statement causes immediate termination 
o f t. h e c u r r e n X o r name d rn a c r o. The next s t a t em e n t p r ocesse d w ill 
be the first one following the macro call. The syntax is: 
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EXITM [<macr o-name>3 
N •:• t. e t h a t n o label is all o ».«.« e d . 
i. 2 CONDITIONAL ASSEMBLY 

T h e s e s t a t em e n t s a 1 1 o w a p r o g r airim e r to selectively assemble 
s t a t em e n t s i n a s o u r c e file. F o r example* if a p r o g r amm e r d i d n o t 
know whether the program was going to be used with a tape or disk* 
b o t h t h e calls t o the tape s u b r o u t i n e and disk s u b r o u tine c o u Id be 
included in the source file* and conditional statements used to 
actually assemble the one needed: 

DEVICE DEFG "TAPE-' 



IF 

LHLD 
CALL- 
ELSE I F 
LHLD 
CALL. 
END IF 



-&DEVICE 

TAPEFCB 

TAPE 10 

•'&DEVICE 

DISKFCB 

DISKIO 



=-TAPE 



DISK 



More often* conditional statements will be used to implement more 
c om p 1 e y, ma c r o s. F o r e ;< am p 1 e , the ADD X mac r o d e f i n e d in s e c t i o n 
i. J., j. could be expanded to add a number between 0 and 255 to the 
BCi DE* or HL registers: 



ADD XV 


MACRO 


REG* NUM 




IF 


•&REG- = 'BC 


REGH 


DEFL 


• ' B •' 


REGL 


DEFL 


•' c •■■ 




ELSE IF 


• &REG-'-- DE 


REGH 


DEFL 


• D' 


REGL 


DEFL 


E • ' 




ELSE 




REGH 


DEFL 


••" H -' 


REGL 


DEFL 


-L • 




END IF 






MOV 


A* &REGL 




AD1 


&NUM 




MOV 


&REGL* A 




MOV 


A* &REGH 




AC I 


0 




MOV 


&REGH* A 



RDGS MANUAL 



ENDM 

ADDXY could be expanded further to add a number between 0 and 
65537 to the BC> DE> or HL registers: 



ADDXY . 


MACRO 


REG, NUM 




IF 


• &REG- --"BC-" 


REGH 


DEFL 


' B " 


REGL 


DEFL 


C 




ELSE IF 


&REG-=- DE 


REGH 


DEFL 


•'D- 


REGL 


DEFL 


•' E 




Er. L— o £ 




REGH 


DEFL 


•'H- 


REGL 


DEFL 


• L-- 




END IF 




NUMH 


DEFL 


&MUM/256 


NUML 


DEFL 


&NUM. MOD. 256 




MOV 


A, &REGL 




AD I 


&NUML 




MOV 


&REGL* A 




MOV 


A, ScREGH 




AC I 


&NUMH 




MOV 


&REGH* A 




ENDM 





One of the more common uses of conditional statements is to 
generate tables that would be long, tedious, and error prone to 
enter by hand. The following example generates a table that could 
be used to check whether a character is numeric- 



TABLE 


EQU 




CHAR 


DEFG 


0 




DO 


256 




IF 


&CHAR <• 0-. OR. &CHAR>'9- 




DC 


0 1 




ELSE 






DC 


X'FF' 1 




END IF 




fcCHAR 


DEFG 


&CHAR+1 




ENDDO 





1. 2. 1 SET SYMBOLS 

pr..et symbols (and macro parameters) are the variables used by the 
conditional statements. Their value may be either numeric (0 to 
65537) or a character string (0 to 32 characters long). The 
values are set by using the DEFG (define global) and DEFL (define 
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i. 2. 1. i DEFL STATEMENT 

This statement is used to define (and redefine) a local set 
symbol. A local set symbol is only known in the macro in which it 
is defined. A set symbol of the same name defined in a different 
macro is actually a different set symbol. The syntax is: 



< s e t- s y m b o 1 - nam e> DEFL 



<expression> 



<s tri ng>" 



If quotes are placed around the operand* it is treated as a 
character string and may be a maximum of 32 characters long. 
Quotes embedded in the string must be doubled. They are* however* 
stored as double* not single* quotes. If quotes are not placed 
a r o u n d t h e o pe r a nd» it is treated as an i n t eg e r * e x p r ess i o n. 
Labels may appear in the expression only if they have been 
previously defined. 

Note that when defining a set symbol* an ampersand must not 
preceed the name in the label field. When using the set symbol* 
an ampersand must preceed the name. 

1.2. 1.2 DEFG STATEMENT 



This statement is used to define (and- redefine) a global set 
symbol. A global set symbol is known in all macros unless a local 
set symbol of the same name is defined in a particular macro. In 
this case* the global set symbol will become unknown* in that 
particular macro only* as soon as the like named local set symbol 
is defined. The syntax is: 



<set~symbol~name> DEFG Cexpressi on> ! v '<s t ri ng>- 

If quotes are placed around the operand* it is treated as a 
character string and may be a maximum of 32 characters long. 
Quotes embedded in the string must be doubled. If quotes are not 
placed around the operand* it is treated as an integer expression. 
Labels may appear in the expression only if they have been 
previously defined. ! 

Note that, when defining a set symbol* an ampersand must not 
preceed the name in the label field. When using the set symbol* 
an ampersand must preceed the name. 

1. 2. 2 IF BLOCK 



An IF block begins with an IF statement and ends with an ENDIF 
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statement. IF blocks may be nested within IF blocks or DO blocks 
to any level. 

i. 2. 2...1 IF STATEMENT 

The IF statement begins an IF block. It may have an optional name 
in the label field which may be referred to in the EXITIF 
statement: If the expression in the operand field of the IF 
s t a t em e n t i s n o n-zer o , t hi e s t a t e merits f. o 1 1 o w i n g t h e IF s t a t em e n t 
up to the first ELSE IF* ELSE; or EXITIF statement at the same 
nesting level will be processed. If the expression is zero* the 
statements following the IF up to the first ELSEIF/ ELSE; or ENDIF 
statement at the same nesting level will be ignored. The syntax 

IS: 



L < i f ~ b 1 o c k- n am e> II IF < e x p r e s s i o n> 

1. 2: 2. 2 ELSE IF STATEMENT 

The ELSEIF statement is used in conjunction with an IF statement 
t o t est a n a 1 1 e r n a t e c o ri d i I i o n w i t h o u t g o i n g t o a deeper n e s t i n g 
level. If the expression in the IF statement was 0 and the 
expressions in all previous ELSEIF statements at this nesting 
level M.«ere 0; and the expression in this ELSEIF statement is 
non-zero, statements up to the next ELSEIF/ ELSE, or ENDIF 
statement at this nesting level will be processed. The syntax is: 



N o t e t h a t n o label is a 1 1 ow e d. 
i. 2. 2. 3 ELSE STATEMENT 

The ELSE- statement is used in conjunction with an IF statement to 
indicate the last alternative.' It is identical to: 



That is* if the expressions in the IF statement and all subsequent 
ELSEIF statements at this nesting level are 0, the statements 
after the ELSE statement up to the closing ENDIF statement are 



ELSEIF 



<expressi on> 



ELSE I F 



i 




The syntax is: 



ELSE 



Note that no label or operand is allowed, 
i. 2. 2. 4 EXITIF STATEMENT 
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The EXITIF statement when processed will cause all statements up 
to the closing ENDIF statement in the named or current IF block to 
be ignored. The syntax is: 

EXITIF C<if-bLock-name>3 
N o t e t h at no label is all ow e d . 
i. 2. 2. 5 END I F STATEMENT 

The ENDIF statement terminates an IF block. The syntax is: 

END I F 

Note that no label or operand is allowed. 
1. 2. 3 DO BLOCK 

^A DO bloc k begins w i t h a DO statement and ends w i t h a n ENDDO 
statement. It causes repetitive assembly of the statements within 
the block. DO blocks may be nested within IF blocks or DO blocks 
to any level. 

i. 2..3. i DO STATEMENT 

The DO statement begins a DO block. It may have an optional name 
in the label field which may be referred to in the EXITDO and 
NEXTDO statements. The expression in the operand field is 
evaluated ONCE at the entry to the DO block and is stored as the 
DO COUNT - the number of times the statements within the block are 
processed. The syntax is: 



L C d o~ b 1 o c k- n am el> 1 DO f. < e x p r e s s i o n> D 

If the expression is omitted* the block will be processed 65538 
times (essentially indefinitely). 

1. 2.3.2 EXITDO STATEMENT 

The EXITDO statements* when processed* causes the assembler to 
immediately terminate processing statements in the current or 
named DO block and begin at the first statement after the closing 
ENDDO statement. The syntax is: 

EXITDO C<do-block~name>D 

Note that no label is allowed. 



i. 2. 3. 3 NEXTDO STATEMENT 
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The NEXTDO statement, when processed, causes the assembler to 
immediately begin processing the next iteration of the current or 
named DO block. That is, if this is hot the last iteration* the 
next statement processed will be the first statement after the DO 
statement. The syntax is: 

NEXTDO C<do-block-name>3 
Note that no label is allowed, 
i. 2. 3. 4 ENDDO STATEMENT 

The ENDDO statement terminates a DO block. The syntax is: 

ENDDO 

Note that no label or operand is allowed. 
1. 2. 3. 5 SUBSTR STATEMENT 

I be SUBSTR (substring) statement assigns a part of a string to a 
It symbol. If the set-symbol has not been previously defined* a 
ew local set-symbol will be defined. The syntax is: 



<set-symbol-name> SUBSTR <expressi o,nl>, <expressi on2>» '<string>" 

<expressi oni> defines the beginning character position of the 
substring. The first character is position 1. -Cexpr essi on2> 
defines the length of the substring. If <expressi on2> is 0, the 
substring will begin with the character defined by <expressi onl> 
and continue to the end of the string. 

1. 2. 3. 6 LENGTH STATEMENT 

The LENGTH statement assigns the length of a string to a set 
symbol. If the set-symbol has not been previously defined, a new 
local set-symbol will be defined. The syntax is: 



<set-symbol-name> LENGTH '<stri ng>'* 
i. 3 ADVANCED CONSIDERATIONS 

Each source line is scanned twice before processing for ampersands 
which signal set symbol or macro parameter substitution. During 
^ach scan any set symbol names preceeded by ampersands have their 
^alues substituted for the ampersand and name. Any doubled 
ampersands are replaced by a single ampersand. This allows the 
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following capabilities: 

1. 3. i SUBSCRIPTED SET SYMBOLS 

The following statement will define a. set symbol whose name is 
based on the value of another set symbol: 

A&I • DEFL . 'A' 

If &I has the integer value 4, the set symbol A00004 will be 
defined to have the value A. The following statement uses the set 
symbol: 



On the first scan* the is replaced by & and &I is replaced by 
00004 leaving: 

MVI B, -&A00004-- 

On the second scan* &A00004 is replaced by A leaving: 



By varying the value of the set symbol I» set symbols may be 
defined and referenced which are indexed using I as a subscript. 

1. 3. 2 INDIRECT SET SYMBOLS 

The fol lowing statements will define a set symbol whose value is 
the name of another set symbol: 



A DEFG -ABC 

B DEFG •A-- 

The following statement will use the set symbol B as an indirect 
reference to the value of set symbol A: 

IF -S^B'^-ABC-' . 

On the first scan* the first two ampersands will be replaced by 

single ampersand and &B will be replaced by A leaving: 



MVI 



Bt -&&AS<I 



MVI 



B, - A - 



IF 



On the second scan* &A -wil.l be replaced by ABC leaving: 

IF 'ABC'='ABC' 
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i. 4 ASSEMBLER PRINT STATEMENT 

The PRINT statement controls which source lines are displayed 
and/or * printed. There are now four possible operands. 

i. 4. I PRINT OFF 

Suppresses printing of all following source lines including 
itself. 

i. 4. 2 PRINT ON 

Causes printing of all source lines except for those in a macro or 
lines skipped due to conditional assembly pseudo-ops or the 
conditional pseudo-ops themselves: DEFG, DEFL, IF, ELSEIF, ELSE* 
END I F i EXITIF, DO, EXITDO, NEXTDO, ENDDO. 

4. 3 PRINT GEN 

Causes printing of all source lines except for those skipped due 
to conditional assembly pseudo-ops or the conditional pseudo-ops 
themselves. A plus sign will be printed to the left of the 
location counter value for source lines contained in a macro. 

i. 4. 4 PRINT ALL 

Causes printing of all source lines including those skipped due to 
conditional assembly pseudo-ops and the pseudo-ops themselves. 
Lines skipped will have no location counter value or object code 
printed. 

i. 4. 5 SUBSTITUTION 

Lines are printed after macro parameter and set symbol 
substitution takes place. 

i. 5 ASSEMBLER EXPRESSIONS 

Operands may now be general expressions containing the 
operators: +, -, unary -,*,/, < , ), . MOD. , . SHR. , . SHL. , . AND. , . OR. * 
. XOR. , an.d . NOT. , as well as the relational operators 

>, <C, >=» O, X. Character strings in quotes may be used as 
arguments with the relational operators. Blanks delimit the 
(expression. Expressions are evaluated left to right. Up to 3 
levels of parentheses are allowed. Operators with higher 
precedence are evaluated before operators of lower precedence that 
immediately preceed or follow them. The operator precedences are 
as foil OWS: 
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7 
6 
5 
4 

3 
2 
i 



Parenthesized expressions 



*, /, . MOD. i . SHL. , . SHR. 
+i -i unary - 
=i >i <> >=» O, >< 
. NOT. 
. AND. 

. OR. , . XOR. 



Exampl es.- 



2+3*4 (result is 14) 
<2+3)*4 (result, is 20) 
5. OR. X'A'" (result is 15) 
5. SHR. 1 ( result, is 2) 
. NOT. 5*4 (result is X'EB") 
•'ABC-ODEF' (result, is 1) 

ABC > •• AB - (result is 1 ) 
'ABC- =• DE •'. OR. 'WXYZ047 (result is 1) 
6300> • DEFG * (result is 0) 
•'A-' - B = A 'B ' (result, is 1) 



Jbte that strings of 2 or less characters are treated as their 
numeric equivalents (i. e. 'AB-' is equal to X-4142'). The null 
string (11) is equal to 0. 

1. 6 RELOCATION PSEUDO- INSTRUCT IONS 

The RDOS Assembler contains the following additional 
pseudo-instructions to implement the relocation features: 



The AS EG statement is used to define an absolute segment. The 
default, for the assembler is an absolute segment starting at 
location zero. After intervening RSEGs* an ASEG instruction will 
reset, the instruction counter to the value of the end of the 
previous absolute segment. 

RSEG <rseg name> 

The RSEG statement defines a relocatable segment. Up to eight 
segments are allowed in one assembly* each identified by a name in 
the operand field. Each RSEG may be stopped and started again 
where they were left off by another RSEG statement with the same 
name. 



J>LBL <symbol>Ci Csymbol 3. . '.. 

The GLBL statement is used to list all the external references and 
entry points in an assembly. A maximum of 255 external references 



ASEG 
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may be used in one assembly. 
ORG < expressi o n> 

The ORG statement is used to reorigin the subsequent lines of 
code. The <expressi on> of the ORG statement must be absolute 
it is in an absolute segment and relative to the start of the 
current RSEG if it is in a relocatable segment. 



1. 7 ASSEMBLER ERROR MESSAGES 

English error messages are now displayed immediately below th 
line in error. More than one message may be printed for each 
line. They should be self explanatory. 
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2. RDOS LINKAGE EDITOR 

Run the Linkage Editor by typing JL. The available options will 
be displayed on the screen. 

2. i LINKAGE EDITOR OPTIONS 

C Input to the Linkage Editor is in a command file 

created using the Editor. The file contains the 
relocatable input filenames* the #ORG and #END 
statements and the RSEG-'s to be included. 

□ An absolute object file is to be written on disk. 

D RSEG's that are not specifically listed are to be 

deleted from the output module. 

S The symbol table is to be read from each input file 

and then appended to the end of the absolute object 
file. The symbol table can then be loaded by the 
debugger and used for symbolic debugging. All 
relative addresses are relocated by adding the base 
address of the appropriate RSEG. 

L List the memory map and reference list on the CRT. 

P Print the memory map and reference list on the 

Mi cropr i nter. 

B Send the memory map and reference list to the Serial 

Port. 

If "C" is specified the Linkage Editor will prompt SPECIFY COMMAND 
FILE. Type the file name and RETURN. // If "C" was not specified the 
Linkage Editor will prompt SPECIFY INPUT FILE. "EnXer the filename 
and RETURN. The Linkage Editor will the open the file/ list, the 
RSEG's and their lengths on the screen and ask INCLUDE THIS FILE?. 
Type M _Y!' to j_ncjj4de the filei " N " to_j^jio_re__iJt. Once a file is 
included* you must not remove the disk containing the file. After 
processing your responsei The Linkage Editor will again prompt 
SPECIFY INPUT FILE. If another file is to be included proceed as 
before* if not enter a RETURN. 

i 

If "O" is specified the Linkage Editor will prompt SPECIFY OBJECT 
FILE. Type the file name and RETURN. 

The Linkage Editor will then prompt LINKER INPUT. 
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2. 2 LINKAGE EDITOR INPUT 



Enter the RSEGs and their locations in memory using the following 
format:. 

#ORG <a bs o 1 u t e add r ess> 

<list of RSEGs to be included separated by commas> 
#ORO ^absolute address) 

<list of RSEGs to be included separated by commas) 
#END < en try point, must be a global symbol > 

If "D" (delete RSEGs) is not specified all RSEGs that are not 
listed are included after the last #GRG statement. 

If an entry point is not specified the default is the entry point 
of the first relocatable file to be included. 

When the Linkage Editor is finished it displays the message 
FUNCTION COMPLETED. 



2. 3 LINKAGE EDITOR COMMAND FILE 



The command file is created using the Editor. It supplies the 
Linkage Editor with the necessary information about input files 
and the desired location for RSEGs. The format of the command 
file is as follows: 



< i h p u t file nam e> 
<input filename) 



< input f i 1 e nam e) 

#ORG < a b s o 1 u t e a d d r e s s> 

•Crseg names separated by commas) 

#ORG <absolute address) 

<rseg names separated by commas) 



#ORG < a bs o 1 u t e a d d r ess) 

•Crseg names separated by commas) 

#END < en try point symbol) 



I 4 LINKAGE EDITOR OUTPUT 

If requested the Linkage Editor will output* to the CRT and/or the 
printeri a reference list and a memory map. 
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The reference list shows for each input file the RSEGs, their 
absolute addresses, and their lengths. It also lists all of the 
global" symbols in each file and their absolute addresses. The 
format of the reference list is as follows: 

FILE RSEG ADDR LENGTH 



GLOBALS 



The memory map shows the memory locations of the RSEGs. It lists 
them in the order in which they were entered in the linker input- 
So if the operands of the #ORG statements were in ass en ding order 
the memory map will also be. The format of the memory map is as 
foil OWS: 

ADDRESS RSEG FILE LENGTH 

If a RSEG was overlaid by another RSEG of the same name, it will 
be flagged by an "O" to the right of the length column, if there 
is more than one RSEG of the same name the first one encountered 
by the Linkage Editor will be used. If a RSEG has been deleted 
<"D" was specified and the RSEG was not listed) the entry in the 
memory map will be flagged with an "D". 

At the end of the listing the entry point for the object module is 
give n. 



2. 5 LINKAGE EDITOR ERROR MESSAGES 



Error messages and their meanings are described in the following 
section. 

NOT A SOURCE FILE - The command file is not an Editor source file. 

NOT A RELOCATABLE FILE - The Linkage Editor input file was not 
created by the Futuredata Relocating Assembler or the "R" 
attribute has been changed using the Monitor. 

PARM ERR. . . RESPECIFY - Syntax error in the linker input. 

<label> **DUPLICATE GLOBAL IN <filename> - The first occurance of 
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a global label is used for address references, all additional 
definitions are flagged as an error. 

<label> **UNRESOLVED REFERENCE IN <filename> - The external 
reference was not found in the global symbol table. 

IN RSEG <rseg> **UNRESOLVED REFERENCE IN <filename> - Reference 
between RSEGs in the same assembly can not be correctly relocated. 
Probable cause is references to a RSEG that has been deleted. 

**DELETED RSEG REFERENCED IN <filename> - An RSEG which was not 
included is needed to resolve address references. 

##ERROR I N COMMAND FILE - Incorrect file name was specified or a 
syntax error in the command file. 

*#RELGCAT I ON ERROR IN <filename> - Input file was not correctly 
assembled with the RDOS assembler. 



•*#TABLE OVERFLOW - More memory is needed by the Linkage Editor. 

**SYMBOL TABLE NOT FOUND IN <filename> - The symbol table was not 
included when the program was assembled. 

•»#SEQUENCE ERROR IN <RELOCATABLE FILE NAME> - records in 
Oelocatable file name> are not in proper order. Reassemble. 
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3. RDOS DEBUGGER 

Run the Debugger by typing JD or JI. The screen will display 
memory centered at 0 in the same format as the Futuredata DOS 
Debugger. All commands are identical to those in the DOS Debugger 
with two exceptions necessary for symbolic debugging: 

3. 1 LOADING A SYMBOL TABLE 

In order to have a symbol table included in an object file* you 
must select the option which causes it to be included both when 
Assembling and Linkage Editing. In order to load the symbol table 
you must specify its beginning address and whether you want all 
symbols or only global symbols at the time you load the program. 
The format of the load command is: 

L <f i 1 ename>r> C<of f set>3 1> IXsymbol table addr ess> 3 C* G3 3 3 

Kinti'ties enclosed in brackets are optional). If <offset> is not 
|Fpecified* its default is 0. If <symbol table address> is not 
specified* but the preceeding comma is* its default is the 
currently displayed address. Examples: 

LI EST. L» * 2000 Loads symbols for TEST. L starting at X'2000* 

L TEST. L> 0* 2000* G Loads global symbols for TEST. L starting at 

X 2000" 

L TEST. L* * * G Loads global symbols for TEST. L starting at 

the currently displayed address 

L TEST. L* 100* Loads symbols for TEST. L starting at the 

currently displayed address. Offsets program 
by X'iOO*. Does not offset addresses* 
however, and thus makes symbol table 
meaningless. 

After reading the symbol table* the Debugger prints the loaded 
length of the table at the bottom of the screen (in hex). 
Ex am pi es: 

SYMTAB LENGTH=015A 
GLOBAL SYMTAB LENGTH=004B 

Bf you attempt to load the symbol table inhere there is no memory 
^•r where there is protected memory* the message 'PARTLY LOADED- 
will be appended to the length message. Example: 
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SYMTAB LENGTH=20iAi PARTLY LOADED 

In this case only part of the symbol table could be loaded. You 
may reference those symbols loaded, in order to load the complete 
symbol * tab 1 e» you must ei ther add more memory or specify a lower 
symbol table address. 

3.2 REFERENCING A SYMBOL 

You may use a symbolic reference wherever you can use a 
hexadecimal address. The syntax of a symbolic reference is: 

=H t-Crel ocatabl e file name): 3<symbol> 

The '-'-relocatable file name> may be necessary since identical 
symbols may occur in separate assemblies. If this is the case* 
and the <rel ocatabl e file name> is not specified, the address of 
the first symbol encountered in the table will be used. Examples: 

DttNEGATE 

D#TESTL R: ST ART +4 

D#TEST 1 . R: START+#TEST2. R: START 

D#BEGIN* 

L i : TEST i , , #SPACE- i 0 

If you use a symbol which is not in the currently loaded symbol 
table, the Debugger displays the message: 

UNDEFINED SYMBOL 

a t 1 1 1 e b o 1 1 om o f the s c r e e n . 
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FUTUREDATA SYSTEM 31 CHECKOUT 



1. Connect the keyboard & CRT to the mainfram. 

CAUTION 

Connecting keyboard into the wrong connector may 
cause dammage to the keyboard. 
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2. Open the mainframe top and connect disk drive connector 
to the rear plug on the TAPE & EIA I/O Board. Ensure 
that red strip on ribbon cable is toward the rear of the 
unit. Ensure that all cards are properly seated. 

.CAUTION 

* '. .. ■ • - ■ . . 

Be careful, if removing CPU card and/or Emulator card. 
They are interconnected with short ribbon cables which 
may become disconnected. Both cards should be removed 
at the same time. 
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3. Connect CRT and Disk power plugs into the auxiliary 
power sockets on the rear of the mainframe. Then plug 
1n the mainframe to a wall socket. 

CAUTION 

Applying or removing power from the disk drive with a 
diskette in the unit may destroy the diskette. 

4. Turn on the power switches on the mainframe and the 
disk drive. 

5* Insert the system diskette, into DRIVE 0 with the label 
toward the power switch, and close the diskette door. 

6. Press the LOAD button on the keyboard; then type D. 
The system will initialized with the prompt; 
FUTUREDATA DISK OPERATING SYSTEM-VER 1.0 

7. Type D, return on the keyboard. A directory of the files 
on the disk will be printed on the CRT. 

CAUTION 

Ensure that the diskette is for the same microporcessor 
as the CPU. i.e. 8080 diskette, 8080 CPU card. 

8. Type JD return. A display of the contents of memory 
around the location 0000 should be seen. 

9. Type JE return. A display of the double dotted line 
editor, plus a prompt at the bottom of the screen . 
should be seen. 

10. Type JA return. A prompt indicating which assembler 
. you have available should be seen. 

11. Type JU return. A display of the copy utility should 
be seen. 

12. This completes the verification of all major functions 
of the Microsystem 31. 

13. Open the disk drive door by pressing straight in on the 
• latch to the left of the door. The- diskette should be 

ejected. 

14. Remove power from all units, and disconnect them. 



GETTING STARTED WITH THE FUTUREDATA 
MICROSYSTEM 31 



INITIALIZING A NEW DISK 



1. Initialize system by applying power, inserting a system 
diskette, pressing the LOAD button, and typing D. 

2. - Place a write enable tape over the write protect slot 

on the rear edge of a blank double density soft sec- 
tored diskette. Then insert it into drive 1 with the 
label facing to the right. 

3. Type I return. The system will respond with the ques- 
tion: INITIALIZE DISKETTE IN DRIVE 1? 

Type Y. Any other response will result in an error 
indication. 

4. When the system is finished initializing the new disk- 
ette, the following message will be displayed: 

FILES ON DRIVE ;1: 76 FREE TRACKS 
PW .1 DIR 



DUPLICATING A DISKETTE 

1. First, initialize a diskette as defined above. 

2. Then insert the diskette to be copied into drive 0, 
leaving the initialized diskette in drive 1. 

3. Type X 0,1, A return. 



DOUBLE DENSITY DISK SYSTEMS 

PRELIMINARY 

1.0 I ntroducti on 

The Mi crosystem/3^ with double density dual disk drive provides 
over 1 megabyte of on-line random access disk storage. The 
diskettes are organized as 77 tracks of 52 sectors each. Each 
sector is 123 bytes. The first track on each diskette is reserved 
for the disk directory. The user may have up to 76 files of one 
track each per diskette, one file of 76 tracks or any combination 
in between. The minimum file is 52 sectors of 123 bytes or 6656 
bytes total. The maximum file is 76 tracks of 6656 bytes or 
505/856 bytes total. 

2. 0 Installation 



The Microdisk/3 may be connected to any Microystem. The 
Microdisk/3 is connected to the Microsystem with a 20 conductor 
flat ribbon cable. Connect the Microdisk/3 cable to J2 on the 
Tape/EIA board. This is the only board with two 20 conductor! 3M 
headers. The red stripe on the cable should be aligned toward the 

^ir of the system and the cable routed out through the flat cable 

Bump at the left rear. 
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See also section 18. 1.2 of "FUTUREDATA DISK OPERATING SYSTEM USERS 
MANUAL" 

It will also be necessary to replace the system bootstrap EPROM. 
The procedure varies somewhat depending on the.CPU card in the 
Microsystem. If the CPU card is a Z-80, 8035, 6800, 6802 or 8080A 
mod II* then the bootstrap EPROM on the processor board is 
^placed. ' The double density EPROM's are labled Z80DD for the 

SOA mod II, 8085, and Z-80. They are labled 68DD for the 6800 
fid 6802. If the CPU card is an 8080A (p. c.^ card 10020 rev. A or 
B> then the following is required. 




i. If it is a tape based system (Mi crosystem/10 or 



double: density disk systems 



Mi c rosy stem/ 15) then the bootstrap EPROM on the Tape/EI A 
board must be disabled as described in 18. 1 of "FUTUREDATA 
.DISK OPERATING SYSTEM USERS MANUAL ". 

2. In addition! tape based systems will require a PROM/ RAM board 
t o h o 1 d t h e d o u b 1 e d e n s i t y b o o t EPROM. This is supplied wi t h 
all Microdisk/3 packages that connect to existing systems and 
all 8080 A systems that do not have the mod II CPU board. 

If a Microprinter is also to be used with the system* then the 
Microprinter is connected to the disk in a daisy chain fashion. 

To connect the printer: remove the top cover on the Microdisk/3 
and connect the 20 connductor printer cable to the 20 connductor 
header clamped to the top of drive 1. Note: the red stripes on 
the the two cables should match. Also note that the Microdisk/3 
must be powered on in order to use the printer* if the printer is 
"daisy chained" through the disk. Under normal operating 
conditions* this is always the case. 

t. O M em o r y S t r a p p i n g 

T h e d o u b 1 e d e n s i t y DOS s o f tw are requires t h e f o 1 1 ow i n g m em o r y 
b o a r d s t r a p p i n g .- 

Systems utilizing SK RAM boards 

1 6K iti em o r y , C o ri ri e c t j urn p e r s at 1 o c a t i o n s 0 * and 5 o n b o a r d 

1. Connect jumpers at locations 1* and 6 on 
board 2. 

C o n n e c t a j urn p e r at 1 o c a t i o n 0 o n b o a r d 1 . 
C o n n e c t j u m p e r s a t 1 o c a t i o n s 1 * an d 5 o n b o a r d 

2 . C o n n e c t j urn p e r s at 1 o c a t i o n s 2 * a n d 6 o n 
board 3/ 

C o n n e c t a ..j urn p e r at 1 o c a t i o n 0 o n b o a r d 1 . 
Connect a .jumper at location 1 on board 2. 
C o n n e c t ..j u m p e r s a t J. o c a t i o n s 2 * an d 5 o n b o a r d 

3 . C o n ri e c t j u m p e r s at. 1 o c a t i o n s 3 » a n d 6 o n 
board 4. 

C o r i n e c t a j urn p er at 1 o c a t i o n 0 o n b o a r d 1 . 
C o n n e •:. t a j urn p e r a t 1 o c a t i o ri 1 o n t. o a r d 2. 
i": o n n e c t a . j urn p e r a t 1 o c a t i b n 2 o n b o a r d 3 . 
C o n ri e c t j urn p e r s a t 1 oca t i o n s 3* a n d 5 o n b o a r d 
4 Connect jumpers at locations 4, and 6 on 
board 5. 

Connect a jumper at location 0 on board i. 



24 K memory 



32K memory 



4 OK memory 



48K memory 



DOUBLE DENSITY DISK SYSTEMS 



16K memory 
32K memory 

48K memory 



32K memory 



48K memory 



Connect a .jumper at location 1 on board 2. 
Connect * jumper at location 2 on board 3. 
Connect a jumper at location 3 on board 4. 
Connect jumpers at locations 4, and 5 on board 
5. Connect a jumper at location 6 on board 6. 

Systems utilizing 16K RAM boards 

Connect jumpers at locations 0> 1* 5* and A6 
on board 1. 

Connect jumpers at locations 0* and i on board 
1.1 Connect jumpers at locations 2* 3* 5» and 
A6 on board 2. 

Connect jumpers at locations 0* and 1 on board 
i. Connect jumpers at locations 2* and 3 on 
board 2. Connect jumpers at locations 4* 5, 
and A6 on board 3. 

Systems utilizing a 32K RAM card. 

Connect jumpers at locations "5-2 11 * "6-3"* and 
"32". 

Systems utilizing 32K and 16K cards. 

Connect jumpers at location "32" on the 32K 
RAM card. Connect jumpers at locations 4/ S*. 
and A6 on the 16K RAM card. 



Systems utilizing a 43K RAM card. 
48K memory Connect jumpers at locations "5-4", ;and "48". 

4.0 Disk Drive Strapping 

Figures 1 and 2 show the option strapping for the double density 
disk drives. Note the different strapping for drive "0" and drive 
"I". Some fault isolation can be accomplished by interchanging 
the functions of drive "0" and drive "1". This is dorre* by 
removing the rear panel. 

CAUTION: POTENTIALLY LETHAL VOLTAGES EXIST INSIDE THE DISK 

• YSTEM. THE POWER CORD MUST BE DISCONNECTED FROM THE WALL 
ET WHENEVER THE COVER OR REAR PANEL ARE REMOVED. 

.he jumpers on the drives may now be altered -tp change drive "0" 
into drive "1" and vice-versa. The 34 conductor cable connecting 
the the two disk drives and disk controller can now be . 
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disconnected from the suspected drive and the other substituted in 
i ts pi ace. 



